home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / tex / macros / source / packages / epic / picman.tex / node9_mn.html < prev    next >
Text File  |  1995-03-15  |  3KB  |  52 lines

  1.  
  2. <H2><A ID="SECTION00036000000000000000">
  3. <TT>\</TT>drawline</A>
  4. </H2>
  5.  
  6. <P>
  7. <#477#><TT>SYNOPSIS:
  8. <BR> \drawline[<#155#><I>stretch</I><#155#>](<I>x</I><SUB>1</SUB>,<I>y</I><SUB>1</SUB>)(<I>x</I><SUB>2</SUB>,<I>y</I><SUB>2</SUB>)...(<I>x</I><SUB>n</SUB>,<I>y</I><SUB>n</SUB>)</TT><#477#>
  9. <BR>where <#156#><I>stretch</I><#156#> is an integer between -100 and infinity.
  10.  
  11. <P>
  12. The above command connects the specified points by drawing a line between
  13. each pair of coordinates using line segments of the closest slope available
  14. in the fonts. At the minimum two points must be specified. Since there are
  15. only finite number of slopes available in the line segment fonts, some lines
  16. appear jagged. A <tex2html_verb_mark>61<tex2html_verb_mark> can be thick or thin depending on the
  17. <tex2html_verb_mark>62<tex2html_verb_mark> or <tex2html_verb_mark>63<tex2html_verb_mark> declaration in effect; these are the
  18. only two thicknesses available for such lines. This is also the most
  19. efficient, in terms of memory and cpu usage, way of drawing lines of
  20. arbitrary slopes.
  21.  
  22. <P>
  23. The <#157#><I>stretch</I><#157#> parameter has properties similar to those described
  24. earlier in the context of dashlines. It is again a percentage and implies a
  25. certain ``stretch'' or ``shrink''; it is optional and by default is ``0''
  26. unless the default itself has been changed (described later). The same rules
  27. apply to the range of the <#158#><I>stretch</I><#158#> value. In this case, the number
  28. ``0'' signifies that a minimum number of dashes be put such that the line
  29. appears solid and each dash ``connected'' at the ends. By reducing the number
  30. of dashes by specifying a -ve <#159#><I>stretch</I><#159#>, one effectively gets a
  31. dashed line. On the other hand, by specifying a +ve <#160#><I>stretch</I><#160#>, more
  32. dashes will be used in constructing the line, giving a less jagged
  33. appearance.
  34.  
  35. <P>
  36. A parameter, namely, <tex2html_verb_mark>64<tex2html_verb_mark>, has been provided for
  37. <tex2html_verb_mark>65<tex2html_verb_mark>'s and its usage is identical to <tex2html_verb_mark>66<tex2html_verb_mark>
  38. described earlier in the context of <tex2html_verb_mark>67<tex2html_verb_mark>.
  39.  
  40. <P>
  41. A limitation of drawing lines using line-segment fonts is that the length of
  42. segments is fixed and is not user-controllable. If explicit control over the
  43. line-segment length is desired, then <tex2html_verb_mark>68<tex2html_verb_mark> may be used.
  44. If the length of the line to be drawn is smaller than the length of available
  45. line segment, then a solid line is constructed using <tex2html_verb_mark>69<tex2html_verb_mark> with
  46. dots being very close; the thickness of the <#161#><I>line</I><#161#> thus constructed is
  47. chosen appropriately. Note that in such a case, only a solid line can be
  48. constructed between the two points, i.e., dashed appearance can not
  49. be given to such small lines, and any -ve stretch is ignored.
  50.  
  51. <P>
  52.